home *** CD-ROM | disk | FTP | other *** search
/ Aminet 41 / Aminet 41 (2001)(Schatztruhe)[!][Feb 2001].iso / Aminet / gfx / show / h8ilbm.readme < prev    next >
Text File  |  2001-01-02  |  4KB  |  112 lines
  1. Short:  HiQuality-HAM8 IFF-24bit image viewer
  2. Author: Smack/Infect! (Michael Henke)
  3. Type:   gfx/show
  4.  
  5. $VER: h8ilbm 0.1 (Sat 16-Dec-2000)
  6.  
  7.  
  8.  #features
  9.    -high quality display for AGA machines (18bit-RGB)
  10.     (this program is not particularly useful for graphics board owners)
  11.  
  12.    -supports IFF-ILBM 24bit files only
  13.     (there is a similar program called 'h8jpg' on Aminet for JPEG images)
  14.  
  15.    -free software (full source code included, of course)
  16.  
  17.  
  18.  #requirements
  19.    -CPU 68020+
  20.    -AmigaOS V37+
  21.    -AGA chipset
  22.    -asyncio.library V39+
  23.  
  24.    -developed on A1200 (68030+882 @ 40MHz, 16MB FastMem, Delfina1200 DSP)
  25.  
  26.  
  27.  #recommended
  28.    -reqtools.library V38+
  29.    -some IFF-ILBM 24bit files
  30.  
  31.  
  32.  #how to use
  33.    h8ilbm is a shell-only program, these options can be used:
  34.  
  35.    FILES............one or more filenames (the keyword FILES is optional).
  36.                     if omitted a reqtools file requester appears.
  37.  
  38.    MID <number>.....screen mode ID.
  39.                     if omitted the default mode ID 0x8020 is used.
  40.                     specify a decimal or hexadecimal (prefix $ or 0x) value.
  41.                     (example: PAL:Super-High Res - 167968 or 0x29020)
  42.  
  43.    SMR..............summon a reqtools screen mode requester.
  44.  
  45.    Use these keys on the h8ilbm screen:
  46.    Esc..................quit
  47.    Space/Return/RMB.....next image
  48.    cursor keys..........scroll image (8 pixels)
  49.    shift + cursor keys..scroll image (32 pixels)
  50.    alt + cursor keys....scroll image (maximum)
  51.    (if the screen is larger than the visible area you can scroll it around
  52.    with mouse movements)
  53.  
  54.  
  55.  #known problems
  56.    -images are shown in a low resolution and/or with wrong aspect ratio
  57.     This is a side-effect of the particular rendering technique used in this
  58.     image viewer. It's sometimes called "18bit-HAM8 RGBB" mode and has often
  59.     been used in demos for colourful 3D-Effects and such stuff. The basic
  60.     principle is that each original true color pixel (24bit) is represented
  61.     by four screen pixels in a special HAM8 pattern. This results in the image
  62.     appearing four times wider on the screen, which can be compensated by
  63.     displaying the screen in a "Super-HiRes" mode (e.g. PAL: 1280x256 pixels).
  64.     The screen then looks like "Low-Res" (320x256) because all those four-
  65.     component pixels mix nicely into single "true color" pixels.
  66.  
  67.    -rendered images use very much chip memory
  68.     This is another consequence of the rendering technique used: graphics
  69.     memory consumption is four times higher than with "normal" image viewers.
  70.     h8ilbm tries to load the entire image into chip memory, creating a large
  71.     screen that can be moved smoothly and easily using the mouse. However, if
  72.     the image is too large then h8ilbm switches to "buffer mode": the image
  73.     is loaded to FastRAM and only a part of it is rendered to a normal-sized
  74.     screen. Move this part around using the keys listed above.
  75.  
  76.  
  77.  #author
  78.    mailto: Michael Henke <smack@smack.de>
  79.  
  80.    h8ilbm - HiQuality-HAM8 IFF-24bit image viewer
  81.    Copyright (C) 2000  Michael Henke
  82.  
  83.    This program is free software; you can redistribute it and/or modify
  84.    it under the terms of the GNU General Public License as published by
  85.    the Free Software Foundation; either version 2 of the License, or
  86.    (at your option) any later version.
  87.  
  88.    This program is distributed in the hope that it will be useful,
  89.    but WITHOUT ANY WARRANTY; without even the implied warranty of
  90.    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  91.    GNU General Public License for more details.
  92.  
  93.    You should have received a copy of the GNU General Public License
  94.    along with this program; if not, write to the Free Software
  95.    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  96.  
  97.  
  98. ============================= Archive contents =============================
  99.  
  100. Original  Packed Ratio    Date     Time    Name
  101. -------- ------- ----- --------- --------  -------------
  102.    18113    7000 61.3% 16-Dec-00 13:21:06 +COPYING
  103.    14952    8861 40.7% 16-Dec-00 13:21:06 +h8ilbm
  104.     3755    1870 50.1% 16-Dec-00 13:21:06 +h8ilbm.readme
  105.      278     202 27.3% 16-Dec-00 13:21:06 +CHANGES
  106.    22723    5505 75.7% 16-Dec-00 13:21:06 +h8ilbm.c
  107.     3127    1123 64.0% 16-Dec-00 13:21:06 +render.asm
  108.      156     110 29.4% 16-Dec-00 13:21:06 +SCOPTIONS
  109.      136      69 49.2% 16-Dec-00 13:21:06 +smakefile
  110. -------- ------- ----- --------- --------
  111.    63240   24740 60.8% 17-Dec-100 03:31:02   8 files
  112.